Calculadora Estructurado

POST /apicbbvrd_estructurado

Descripción: Endpoint utilizado para ejecutar cálculos de productos estructurados en los cuales se pueden ejecutar escenarios de sell-buy-back y mutuos estructurados. Calcula tanto la operación spot como la forward aplicando una tasa de interés estructurada.

Parámetros:

• titulo_id - Nemotécnico o código ISIN del título que desea calcular
• tipo_insumo - r (rendimiento), p (precio) o t (transado). Define el tipo de insumo para la operación spot
• tipo_monto - n (nominal) o t (transado). Define el tipo de monto
• insumo - Valor del insumo declarado en el campo tipo_insumo
• monto - Valor del monto declarado en el campo tipo_monto
• fecha_liquidacion_spot - Fecha de liquidación spot que sirve de base para calcular la fecha forward, formato YYYY-MM-DD
• tasa - Tasa de interés anual bajo la cual se ejecuta la operación estructurada
• dias - Cantidad de días entre la operación spot y la forward
• cesion_cupon - true/false para modelar cesión de cupón si existe pago entre spot y forward
• base_dias - Base de días para cálculo de intereses (360 o 365)
• Config:
  • with_flujos - true/false para incluir los flujos en la respuesta

Consulta:

Ejemplo Body

{
  "auth": {
    "usuario": "colocar_usuario",
    "password": "colocar_password"
  },
  "calculo": [
    {
      "titulo_id": "MH22034",
      "tipo_insumo": "t",
      "tipo_monto": "n",
      "insumo": 1534000,
      "monto": 1200000,
      "fecha_liquidacion_spot": "2024-07-19",
      "tasa": 10,
      "dias": 30,
      "cesion_cupon": false,
      "base_dias": 360
    }
  ],
  "config": {
    "with_flujos": false
  }
}

Python

import requests

url = 'https://calculadora.bvrd.exchange/apicbbvrd_estructurado'
body = {
    "auth": {
        "usuario": "colocar_usuario",
        "password": "colocar_password"
    },
    "calculo": [
        {
            "titulo_id": "MH22034",
            "tipo_insumo": "t",
            "tipo_monto": "n",
            "insumo": 1534000,
            "monto": 1200000,
            "fecha_liquidacion_spot": "2024-07-19",
            "tasa": 10,
            "dias": 30,
            "cesion_cupon": False,
            "base_dias": 360
        }
    ],
    "config": {
        "with_flujos": False
    }
}

response = requests.post(url, json=body)
print(response.json())

Respuesta:

JSON

[
  {
    "calculo_estructurado": {
      "nemotecnico": "MH22034",
      "codisin": "DO1005210922",
      "emisor": "Ministerio de Hacienda",
      "moneda": "DOP",
      "nombre_instrumento": "Bonos de Deuda Ley 64-18",
      "nombre_periodo": "Semestral",
      "tipo_amortizacion_capital": "No Amortizable",
      "base_liquidacion": "Actual/Actual",
      "cantidad_titulos": 12,
      "monto_nominal": 1200000,
      "valor_nominal_unitario": 100000,
      "cupon": 13,
      "interes_estructurado": 12783.330000004265,
      "monto_cupon_cedido": 0,
      "suma_flujos": 0,
      "dias_corrido_spot": 39,
      "dias_corrido_fwd": 69,
      "cupon_corrido_spot": 16622.95081967213,
      "cupon_corrido_fwd": 29409.836065573767,
      "monto_transado_spot": 1533999.9999999967,
      "monto_transado_fwd": 1546783.330000001,
      "monto_limpio_spot": 1517377.0491803247,
      "monto_limpio_fwd": 1517373.4939344272,
      "precio_limpio_spot": 126.44808743169371,
      "precio_limpio_fwd": 126.44779116120226,
      "precio_sucio_spot": 127.83333333333306,
      "precio_sucio_fwd": 128.89861083333344,
      "rendimiento_spot": 8.915661799009772,
      "rendimiento_fwd": 8.8961474597106,
      "carry_acumulado": 14256.65,
      "carry_neto": 1473.32,
      "dias_acum": 30,
      "fecha_liquidacion_spot": "2024-07-19",
      "fecha_liquidacion_fwd": "2024-08-18"
    }
  }
]